지상관측

목측과 자동기상관측장비, 황사관측장비 등으로 관측한 일기현상, 기온, 강수, 바람, 황사, 자외선 등의 데이터를 제공합니다.

api 상세
개요

방재기상관측이란 지진 · 태풍 · 홍수 · 가뭄 등 기상현상에 따른 자연재해를 막기 위해 실시하는 지상관측을 말합니다. 관측 공백 해소 및 국지적인 기상 현상을 파악하기 위하여 전국 약 510여 지점에 자동기상관측장비(AWS, Automatic Weather System)를 설치하여 자동으로 관측합니다.
요 소

기온, 강수, 풍향, 풍속 등
지 점

510지점 (2020. 4. 1. 기준)
보유기간

1997년 1월 ~ 현재(지점별 상이함)
생산주기

분, 시간, 일, 월, 연 자료

1. AWS2 포맷 매분자료 조회

호출URL정보

AWS2 매분자료

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min?tm2=202302010900&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

authKey

인증키

발급된 API 인증키

호출URL정보

AWS2 초상,지면,지중온도

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_lst?tm2=202302010900&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

년월일시분(KST)

조회할 시간 (없으면 현재시간)

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

gov

기관코드

stn_obs에 정의된 기관코드 지점만 처리(여러 기관은 :으로 구분)

stn_sp

장비코드

stn_obs에 정의된 장비코드 지점만 처리(여러 장비는 :으로 구분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

자료포맷

설명

현천코드 : 0~2(맑음), 4(연무), 10(박무), 30(안개), 40~42(비), 50~59(안개비), 60~68(비), 71~76(눈)

authKey

인증키

발급된 API 인증키

호출URL정보

AWS2 운고,운량자료

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_cloud?tm2=202302010900&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

itv

시간간격

(분)

sms

평활화여부

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

authKey

인증키

발급된 API 인증키

호출URL정보

AWS2 운고,운량자료(최저·최고 운고)

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_ca2?tm2=201503221200&itv=10&range=10&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

range

평균을 위한 누적기간(분)

itv

시간간격

(분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

authKey

인증키

발급된 API 인증키

호출URL정보

AWS2 운고,운량자료(상층·중층·하층 운고)

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_ca3?tm2=201503221200&itv=10&range=10&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

range

평균을 위한 누적기간(분)

itv

시간간격

(분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

CH_MIN

최저 운고(m)

CH_MAX

최고 운고(m)

CA_TOT

전운량(1/8)

호출URL정보

AWS2 시정자료

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_vis?tm2=201507140812&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

itv

시간간격

(분)

sms

평활화여부

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

S

장비구분

VIS1

1분 평균 시정(m)

VIS1

10분 평균 시정(m)

WW1

1분 순간 현천(코드)

WW15

15분 평균 현천(코드)

호출URL정보

AWS2 시정자료(평균·최소·최고 시정)

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_vis3?tm2=201503221200&itv=10&range=10&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

range

평균을 위한 누적기간(분)

itv

시간간격

(분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

qc

qc 적용여부

authKey

인증키

발급된 API 인증키

호출URL정보

AWS2 현천자료

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_ww1?tm2=201503221200&itv=60&range=60&stn=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

년월일시분(KST)

조회할 시간 (없으면 현재시간)

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

gov

기관코드

stn_obs에 정의된 기관코드 지점만 처리(여러 기관은 :으로 구분)

stn_sp

장비코드

stn_obs에 정의된 장비코드 지점만 처리(여러 장비는 :으로 구분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

자료포맷

설명

현천코드 : 0~2(맑음), 4(연무), 10(박무), 30(안개), 40~42(비), 50~59(안개비), 60~68(비), 71~76(눈)

authKey

인증키

발급된 API 인증키

호출URL정보

AWS2 현천, 분석

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws2_min_ww2?tm2=201503221200&itv=10&range=10&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm

년월일시분(KST)

조회할 시간 (없으면 현재시간)

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

gov

기관코드

stn_obs에 정의된 기관코드 지점만 처리(여러 기관은 :으로 구분)

stn_sp

장비코드

stn_obs에 정의된 장비코드 지점만 처리(여러 장비는 :으로 구분)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

자료포맷

설명

현천코드 : 0~2(맑음), 4(연무), 10(박무), 30(안개), 40~42(비), 50~59(안개비), 60~68(비), 71~76(눈)

authKey

인증키

발급된 API 인증키

2. 이동형 관측자료 조회

호출URL정보

이동형 관측자료

https://apihub.kma.go.kr/api/typ01/cgi-bin/url/nph-aws3_min_mob?tm1=202108011455&tm2=202108011500&stn=&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)

조회할 시간구간의 시작시간 (없으면 종료시간과 같음)기간은 전체지점이면 10분, 1개 지점이면 하루이내로 처리

tm2

년월일시분(KST)

조회할 시간구간의 종료시간 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

disp

표출형태

0 : 변수별로 일정한 길이 유지, 포트란에 적합 (default)1 : 구분자(,)로 구분, 엑셀에 적합

help

도움말

0 : 시작과 종료표시 + 변수명 (default)1 : 0 + 변수에 대한 설명2 : 전혀 표시않음 (값만 표시)

authKey

인증키

발급된 API 인증키

3. AWS 시간통계 자료 조회

호출URL정보

기온

https://apihub.kma.go.kr/api/typ01/url/awsh.php?var=TA&tm=201508121500&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

바람

https://apihub.kma.go.kr/api/typ01/url/awsh.php?var=WD&tm=201508121500&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

강수

https://apihub.kma.go.kr/api/typ01/url/awsh.php?var=RN&tm=201508121500&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

습도

https://apihub.kma.go.kr/api/typ01/url/awsh.php?var=HM&tm=201508121500&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

기압

https://apihub.kma.go.kr/api/typ01/url/awsh.php?var=PS&tm=201508121500&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

정시자료

https://apihub.kma.go.kr/api/typ01/url/awsh.php?tm=201508121500&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

var

변수종류

TA(기온), WD(바람), RN(강수), HM(습도), PS(기압)없으면 각 변수별 정시자료

tm

년월일시분(KST)

해당 시점에 존재하는 지점목록 (없으면 현재시간)

stn

지점번호

해당 지점의 정보 표출 (0 이거나 없으면 전체지점)

disp

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

TA

정시기온 (C)

TA_HMI

정시기온 시각차

TA_AVG

과거 60분간 매분기온 평균 (C)

TA_QCM

사용된 매분자료 수

TA_MAX

과거 60분간 매분기온 최고 (C)

TA_MAX_MI

위 최고기온의 시각차

TA_MIN

과거 60분간 매분기온 최저 (C)

TA_MIN_MI

위 최저기온의 시각차

WD

정시 10분 평균 풍향 (degee)

WS

정시 10분 평균 풍속 (m/s)

WS_HMI

위 정시 바람 시각차

WD_MAX

과거 60분간 10분 평균 바람중 최대풍향 (degee)

WS_MAX

과거 60분간 10분 평균 바람중 최대풍속 (m/s)

WS_MAX_MI

위 최대풍속의 시각차

WS_QCM

과거 60분간 사용된 10분 풍속의 자료 수

WS1_AVG

과거 60분간 매분 풍속의 평균 (m/s)

WD1_MAX

과거 60분간 1분 평균 바람중 최대풍향 (degee)

WS1_MAX

과거 60분간 1분 평균 바람중 최대풍속 (m/s)

WS1_QCM

과거 60분간 사용된 1분 풍속의 자료 수

RE_SUM

과거 60분간 '강수있음'의 분수 합

RE_QCM

과거 60분간 사용된 '강수유무' 자료수 합

RN_DAY

해당시간까지의 일강수량 (mm)

RN_DAY_MI

위 일강수량의 시간차

RN_HR1

1시간 강수량 (mm)

RN_HR1_MI

관측시간-1시간 강수량 누적 시작 시간차 (분)

HM

정시습도 (%)

HM_HMI

정시습도 시각차

HM_AVG

과거 60분간 매분습도 평균 (C)

HM_QCM

사용된 매분자료 수

HM_MAX

과거 60분간 매분습도 최고 (%)

HM_MAX_MI

위 최고습도의 시각차

HM_MIN

과거 60분간 매분습도 최저 (%)

HM_MIN_MI

위 최저습도의 시각차

PA

정시 현지기압 (hPa)

PA_HMI

정시 현지기압 시각차

PA_AVG

과거 60분간 매분 현지기압 평균 (hPa)

PA_QCM

사용된 매분 현지기압자료 수

PA_MAX

과거 60분간 매분 현지기압 최고 (hPa)

PA_MAX_MI

위 최고 현지기압의 시각차

PA_MIN

과거 60분간 매분 현지기압 최저 (hPa)

PA_MIN_MI

위 최저 현지기압의 시각차

PS

정시 해면기압 (hPa)

PS_HMI

정시 해면기압 시각차

PS_AVG

과거 60분간 매분 해면기압 평균 (hPa)

PS_QCM

사용된 매분 해면기압 자료 수

PS_MAX

과거 60분간 매분 해면기압 최고 (hPa)

PS_MAX_MI

위 최고 해면기압의 시각차

PS_MIN

과거 60분간 매분 해면기압 최저 (hPa)

PS_MIN_MI

위 최저 해면기압의 시각차

TM

시각(KST,년월일시)

STN

지점번호

4. 지상 및 AWS 일통계 자료 조회

호출URL정보

요소별 조회

https://apihub.kma.go.kr/api/typ01/url/sfc_aws_day.php?tm2=20150406&obs=ta_max&stn=0&disp=0&help=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

tm1

년월일시분(KST)
년월일(KST)

기간: 시작시간 또는 시작일 (없으면 현재시간)

tm2

년월일시분(KST)
년월일(KST)

기간: 종료시간 또는 종료일 (없으면 현재시간)

obs

기상요소

rn_day : 일강수량, ta_max : 일 최고기온
ta_max_dif : 최고기온차(오늘-어제), ta_max_min : 일교차
ta_min : 일 최저기온, ta_min_dif : 최저기온차(오늘-어제)
ws_max : 일 최대풍속, ws_ins_max : 일 최대 순간풍속
sd_tot_max : 최심적설, sd_day_max : 최심 신적설

stn

지점번호

해당 지점들(:로 구분)의 정보 표출 (0 이거나 없으면 전체지점)

help

도움말추가

1 이면 필드에 대한 약간의 도움말 추가 (0 이거나 없으면 없음)

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

TM

관측시각 (KST)

STN

국내 지점번호

LON

경도 (deg)

LAT

위도 (deg)

HT

노장 해발고도 (m)

VAL

조회된 값

5. 방재기상연보 조회

호출URL정보

지점별월요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsYearlyInfoService/getStnbyMmSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=96&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

‘2016년 발표’

month

발표월

‘16년09월 발표’

station

지역 코드

‘096지역’

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

관측 지점 번호

stn_ko

관측 지점명(국문)

stn_en

관측 지점명(영문)

str

항목이름

taDay{month}

항목 별 값(단위 0.1)

호출URL정보

연요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsYearlyInfoService/getYearSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지점번호

stn_ko

지점명(국문)

taDay

기온 평균

taMaxAvg

최저 기온의 평균

taMaxDay

연최고기온 나타난날

taMax

연최고기온

taMinAvg

연최저기온 평균

taMin

기온-최저

taMinDay

연최저기온 나타난 날

wsDay

연평균풍속

wsInsMax

연최대순간풍속

wdInsMax

연최대순간풍속 풍향

wsInsMaxTm

연최대순간풍속 나타난

rnDay

연 총 강수량

rn1hrMax

연 시간 최다 강수량

호출URL정보

방재기상관측지점일람표조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsYearlyInfoService/getAwsStnLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지역코드

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

북위

lon

동경

ht

해발고도

호출URL정보

일러두기조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsYearlyInfoService/getNote?pageNo=1&numOfRows=10&dataType=XML&year=2016&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

note

일러두기

6. 방재기상월보 조회

호출URL정보

일별방재기상관측자료조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsMtlyInfoService/getDailyAwsData?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&station=129&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

month

발표월

09월 발표

station

지역 코드

지역 코드

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

관측 지점 번호

stn_ko

관측 지점명(국문)

stn_en

관측 지점명(영문)

info-tm

날짜

info-ta_day

평균 기온

info-ta_max

최고 기온

info-ta_min

최저 기온

info-wd_day

평균풍속

info-ws_ins_max

최대순간 풍속

info-wd_ins_max

최대순간 풍향

info-rn_day

강수량

호출URL정보

월요약자료조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsMtlyInfoService/getMmSumry?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지점번호

stn_ko

지점명(국문)

avg_ta_max

최고 기온의 평균

avg_ta_min

최저 기온의 평균

avg_ta_day

월평균기온

ta_max

월최고 기온

ta_max_dd

월최고기온 나타난날

ta_min

기온-최저

ta_min_dd

월최저기온 나타난날

avg_ws_day

월평균풍속

ws_ins_max

월최대순간풍속

wd_ins_max

월최대순간풍속 풍향

ws_ins_max_dd

월최대순간풍속 나타난 날

sum_rn_day

월 강수량

rn_1hr_max

월 시간 최다 강수량

rn_1hr_max_dd

강수량-최다-나타난날

호출URL정보

방재기상관측지점일람표조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsMtlyInfoService/getAwsStnLstTbl?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

stn_id

지역코드

stn_ko

지역명(국문)

stn_en

지역명(영문)

lat

북위

lon

동경

ht

해발고도

호출URL정보

일러두기조회

https://apihub.kma.go.kr/api/typ02/openApi/AwsMtlyInfoService/getNote?pageNo=1&numOfRows=10&dataType=XML&year=2016&month=09&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

pageNo

페이지 번호

페이지번호

numOfRows

한 페이지 결과 수

한 페이지 결과 수

dataType

응답자료형식

요청자료형식(XML/JSON)

year

발표년도

2016년 발표

month

발표월

09월 발표

authKey

인증키

발급된 API 인증키

출력결과

출력결과
변수명 의미(단위) 변수명 의미(단위)

resultCode

결과코드

resultMsg

결과메시지

numOfRows

한 페이지 결과 수

pageNo

페이지 번호

totalCount

전체 결과 수

dataType

데이터 타입

note

일러두기

7. (그래픽) 지상기상현상(관서) 조회

호출URL정보

현상(현천계)

https://apihub.kma.go.kr/api/typ03/php/alw/aws/aws_ww_pnt.php?obs=ww_vis&tm=202212221120&val=1&stn=1&obj=mq&map=HR&grid=2&legend=1&size=600&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

obj

객관분석 방식

bn : barnes
mq : multi-quadric

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

grid

격자 크기

(km)

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

gov

기관코드

val

authKey

인증키

발급된 API 인증키

8. (그래픽) 일기상통계 조회

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-aws_day_img1?obs=rn_day&tm=202212221315&val=1&stn=1&obj=mq&map=HR&grid=2&legend=1&size=600&zoom_level=0&zoom_x=0000000&zoom_y=0000000&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

val

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

obj

객관분석 방식

bn : barnes
mq : multi-quadric

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

grid

격자 크기

(km)

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

authKey

인증키

발급된 API 인증키

9. (그래픽) AWS 분포도 조회

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-aws_min_img1?obs=rn_ex&tm=202305021355&val=1&stn=1&obj=mq&map=D3&grid=2&legend=1&size=330.00&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&_DT=RSW:RNEX&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

obj

객관분석 방식

bn : barnes
mq : multi-quadric

ws_ms

풍속 단위

(kh: km/h, ms: m/s)

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

grid

격자 크기

(km)

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

gov

기관코드

val

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-aws_min_img2?obs=wv_10m&tm=202305021405&val=1&stn=1&obj=mq&ws_ms=kh&map=D3&grid=2&legend=1&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

obj

객관분석 방식

bn : barnes
mq : multi-quadric

ws_ms

풍속 단위

(kh: km/h, ms: m/s)

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

grid

격자 크기

(km)

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

gov

기관코드

val

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ03/php/alw/aws/aws_obs_pnt.php?obs=vs&tm=202305030945&val=1&stn=1&obj=bn&map=D3&grid=2&legend=1&size=330.00&itv=10&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

obj

객관분석 방식

bn : barnes
mq : multi-quadric

ws_ms

풍속 단위

(kh: km/h, ms: m/s)

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

grid

격자 크기

(km)

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

gov

기관코드

val

authKey

인증키

발급된 API 인증키

호출URL정보

https://apihub.kma.go.kr/api/typ03/php/alw/sea/sea_obs_pnt.php?obs=sea_wh&tm=202305030950&val=1&stn=1&obj=mq&map=D3&grid=2&legend=1&size=330.00&itv=5&zoom_level=0&zoom_x=0000000&zoom_y=0000000&gov=&_DT=RSW:SEAWH&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

obs

관측자료 종류

tm

조회할 자료시각

YYYYMMDDHHM

stn

지점정보 포함

0 : 최대최소값만
1 : 영역내 지점값 포함
2 : 지점값만

obj

객관분석 방식

bn : barnes
mq : multi-quadric

ws_ms

풍속 단위

(kh: km/h, ms: m/s)

map

지도코드

D2 : 남한
D3 : 남한
R : 레이더
B : 한반도
H1 : 한반도

grid

격자 크기

(km)

legend

범례 표시 여부

0 : 표시하지 않음
1 : 표시

size

이미지 크기

(가로, 세로 pixel)

itv

시간간격

(분)

gov

기관코드

val

authKey

인증키

발급된 API 인증키

10. (그래픽) AWS 시계열 조회

호출URL정보

6시간

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-awsm_tms_h06?202305031000&0&108,419,415,421,413,408,409,414,424,406,407,416,412,411,405,404,110,423,417,418,510,889,410,509,425,401,400,403,402&m&108,419,415,421,413,408,409,414,424,406,407,416,412,411,405,404,110,423,417,418,510,889,410,509,425,401,400,403,402&kh&_DT=RSW:AWSCHART&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

12시간

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-awsm_tms_h12?202305030900&0&108,419,415,421,413,408,409,414,424,406,407,416,412,411,405,404,110,423,417,418,510,889,410,509,425,401,400,403,402&m&0&108,419,415,421,413,408,409,414,424,406,407,416,412,411,405,404,110,423,417,418,510,889,410,509,425,401,400,403,402&kh&_DT=RSW:AWSCHART&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

24시간

https://apihub.kma.go.kr/api/typ03/cgi/aws2/nph-awsm_tms_h24?202212291159&0&239,494,496,611,629&m&239,494,496,611,629&ms&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

2일

https://apihub.kma.go.kr/api/typ03/cgi/aws2/nph-awsm_tms_d02?202212291158&0&239,494,496,611,629&m&0&239,494,496,611,629&ms&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

4일

https://apihub.kma.go.kr/api/typ03/cgi/aws2/nph-awsm_tms_d04?202212291157&0&239,494,496,611,629&m&239,494,496,611,629&ms&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

8일

https://apihub.kma.go.kr/api/typ03/cgi/aws2/nph-awsm_tms_d08?202212291156&0&239,494,496,611,629&m&239,494,496,611,629&ms&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

12일

https://apihub.kma.go.kr/api/typ03/cgi/aws2/nph-awsm_tms_d12?202212291155&0&239,494,496,611,629&m&239,494,496,611,629&ms&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

URL

Path 의미

api/typ03/cgi/aws2/nph-awsm_tms_h06?{자료시각}&0&{지점}&m&{지점}&{풍속}&authKey={인증키}

자료시각

조회할 자료시각

지점

조회할 지점

풍속

풍속 단위

kh(km/hr), ms(m/s)

authKey

인증키

발급된 API 인증키

11. (그래픽) AWS 분포도 조회(배경지도 없음)

출력결과는 투영법, 이미지파일 위치 등이 JSON 포맷으로 표출됨 ※ url 이후 나오는 경로 앞에 https://apihub.kma.go.kr을 붙여서 사용

호출URL정보

일 최고기온

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-aws_day_imgp1?PROJ=LCC&map=D&grid=2&itv=5&dataDtlCd=aws_ta_max_0&obs=ta_max&stn=0&size=320&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307121600&tm_st=202307121600&tm_ed=202307121600&tm2=202307121600&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

경량화 PROJECT ID

STARTX

시작 X 좌표

시작 X 좌표

STARTY

시작 Y 좌표

시작 Y 좌표

ENDX

종료 X 좌표

종료 X 좌표

ENDY

종료 Y 좌표

종료 Y 좌표

ZOOMLVL

현재 줌 Level

현재 줌 Level

tm

현재시각

현재시각

tm_st

시작 시각

시작 시각

map

지도종류

지도종류

grid

격자크기

격자크기(km)

itv

분석간격

분석간격(분)

dataDtlCd

경량화 Layer Name

경량화 Layer Name

obs

변수 구분

변수 구분 (예: ta)

stn

지점정보

지점정보 포함(0:최대최소값만, 1:영역내 지점값 포함, 2:지점값만 객관분석없음)

size

이미지크기

이미지크기(픽셀)

selWs

풍속단위

풍속 단위 (kh: km/h, ms: m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

강우감지

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-aws_min_imgp1?PROJ=LCC&map=D&grid=2&itv=5&dataDtlCd=aws_rn_ex_0&obs=rn_ex&stn=0&size=320&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307121600&tm_st=202307121600&tm_ed=202307121600&tm2=202307121600&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

경량화 PROJECT ID

STARTX

시작 X 좌표

시작 X 좌표

STARTY

시작 Y 좌표

시작 Y 좌표

ENDX

종료 X 좌표

종료 X 좌표

ENDY

종료 Y 좌표

종료 Y 좌표

ZOOMLVL

현재 줌 Level

현재 줌 Level

tm

현재시각

현재시각

tm_st

시작 시각

시작 시각

map

지도종류

지도종류

grid

격자크기

격자크기(km)

itv

분석간격

분석간격(분)

dataDtlCd

경량화 Layer Name

경량화 Layer Name

obs

변수 구분

변수 구분 (예: ta)

stn

지점정보

지점정보 포함(0:최대최소값만, 1:영역내 지점값 포함, 2:지점값만 객관분석없음)

size

이미지크기

이미지크기(픽셀)

selWs

풍속단위

풍속 단위 (kh: km/h, ms: m/s)

authKey

인증키

발급된 API 인증키

호출URL정보

바람벡터

https://apihub.kma.go.kr/api/typ03/cgi/aws3/nph-aws_min_imgp2?PROJ=LCC&map=D&grid=2&itv=5&dataDtlCd=aws_rn_ex_0&obs=rn_ex&stn=0&size=320&STARTX=-384032.28285233676&STARTY=4878817.500765007&ENDX=758967.7171476632&ENDY=3778150.834098339&ZOOMLVL=11&selWs=kh&tm=202307121600&tm_st=202307121600&tm_ed=202307121600&tm2=202307121600&authKey=vhBFrPBaSiWQRazwWlolWg

요청인자

데이터 기본 정보
인자명 의미 설명

PROJ

경량화 PROJECT ID

경량화 PROJECT ID

STARTX

시작 X 좌표

시작 X 좌표

STARTY

시작 Y 좌표

시작 Y 좌표

ENDX

종료 X 좌표

종료 X 좌표

ENDY

종료 Y 좌표

종료 Y 좌표

ZOOMLVL

현재 줌 Level

현재 줌 Level

tm

현재시각

현재시각

tm_st

시작 시각

시작 시각

map

지도종류

지도종류

grid

격자크기

격자크기(km)

itv

분석간격

분석간격(분)

dataDtlCd

경량화 Layer Name

경량화 Layer Name

obs

변수 구분

변수 구분 (예: ta)

stn

지점정보

지점정보 포함(0:최대최소값만, 1:영역내 지점값 포함, 2:지점값만 객관분석없음)

size

이미지크기

이미지크기(픽셀)

selWs

풍속단위

풍속 단위 (kh: km/h, ms: m/s)

authKey

인증키

발급된 API 인증키